Turnbull China Bikeride

home *** CD-ROM | disk | FTP | other *** search

/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / GAMES / TOOLS / MAPPER.ZIP / !Mapper_o / !Help < prev next >

Wrap

Text File | 1997-11-01 | 13KB | 376 lines

* * *** **** **** ***** **** ** ** * * * * * * * * * * * * ***** **** **** *** **** * * * * * * * * * * * * * * * ***** * * Version : 4.00 Released : 14/12/96 Version : 4.10 Updated : 1/11/97 I. Contents : 1............Introduction 2............What is a map editor ? 3............The legal bit 3............The differences 3............System requirements 3............Extra commands 4............The WIMP options 5............The editing screen 5............Key commands 6............The Sprite Overlay System™ 6............Saving and loading 7............MAP format A............Glossary B............And finally... C............The new bits... 1. Introduction ---------------- Welcome to the very last version of !Mapper - because this is the ultimate version of my !Mapper series, there is no need to do any more, apart from probably the odd bug fix or update. 2. What is a map editor? ------------------------- A map editor is normally used for 2D games, for example Chaos Engine, Cannon Fodder etc. etc., and allows you to position background sprites anywhere within a defined area. When you come to display the background in your program, the code used will tell you which sprite you need to display. You could do things the hard way, and design the background completely in some art package, but to do so will use a lot of memory and you will have a hard job animating sprites and performing special actions. Alternatively you could type in DATA statements into your program, but doing so is slow, boring and prone to error. Let !Mapper V4.xx increase your productivity... 3. The legal bit ----------------- !Mapper+, !Mapper V3.xx, and !Mapper V4.xx are (C) Nicholas Kingsley Bsc 1995/1996 The Sprite Overlay System is trademark of Nicholas Kingsley All unauthorised coping, reverse engineering, lending, loaning is strictly forbidden without MY WRITTEN PERMISSION. Thanks to Pineapple Software for the filetype allocation of the MAP filetype. 4. The differences ------------------- Most of the options in !Mapper V3.xx were not needed. Here is a list of the differences between the two : Functions removed : A) X and Y Mirroring B) Compression saving C) Virtual memory D) Editing grid Functions that are the same : A) Mouse functions are generally the same B) The WIMP options are the same (but have been extended) Functions added : A) Multiple editing modes B) Sprite Overlay System™ C) Each sprite has status information 5. System Requirements ---------------------- You will need at least 1Mb to run this program (although you can change various items to run the program if you are low in memory). The program has only be tested on a RISC OS V3.11 and so MAY NOT run on other machines. UPDATE : This program will run on a StrongArm computer. 5. Extra commands ------------------ The following commands must be placed just before the comment on the last line of the !Run file. Each command must be separated from the previous command and the parameter value by a space. The commands are : -xsize <value> - This changes the default value for the maximum value for the map width. The value can be any size between 1 and 255 -ysize <value> - This changes the default value for the maximum value for the map height. The value can be any size between 1 and 255 -layers <value> - This changes the default value for the number of layers. The value can be between 1 and 255 -sprites <values> - This changes the default value for the maximum number of sprites that can be read. The value can be between 1 and 999 UPDATE : -repeat <value> - This changes the speed at which the computer scrolls through the different sprites. The value can be between 1 and 255 NOTE : If the computer can't claim enough memory for any value, an error message will be displayed, and the program will remove itself from memory. 6. The WIMP options -------------------- There are very few WIMP options. These are to be found in "Change Map" and "Save Map". The values in "Change Map" affect ALL the layers. The "Change Map" options are : Layer X Size - This allows any value between 1 and the current maximum width allowed, and changes the width of the map. Layer Y Size - This allows any value between 1 and the current maximum height allowed, and changes the height of the map. Delete value - This allows any value between 0 and 65535, and governs what value is stored when the delete button is pressed on the mouse. Delete values can have sprites associated with them, and if they do then the correct sprite is displayed when you delete graphic. Mask value - This allows any value between 0 and 255 and is only used with the Sprite Overlay System™. This governs what value will be ignored multiple layers are displayed. Please read the overlay system text The following headings allow you to set up global status values, without having to press the MIDDLE button after plotting each tile : Walkability, Special #1, Special #2 and Special #3 - Click on the box to active the speciality. Animation frames - Used only in your own programs, this lets you know how many animation frames a tile has X Modify and Y Modify - Activated ONLY when Special #3 has been selected, this is only used in your own programs to help implement hidden walls, floors etc., by defining the character X and Y position L Modify - Used as above, but specifies which layer the hidden tile is on. The "Save Map" options : The button next to "All" determines how many layers are saved. With it crossed then ALL layers are saved. When it isn't then only the CURRENT EDITED layer is saved. 7. The editing screen ---------------------- In the default editing map ("Normal editing") then screen is split into two parts. The top displays the sprites, while the second part at the bottom displays some useful information about the current layer : Layr - Current layer number XSize - Current WIDTH of the map YSize - Current HEIGHT of the map X: - Current X position of the pointer in the current layer Y: - Current Y position of the pointer in the current layer The boxes in the left size of the screen contain the previous sprite graphic, the current sprite graphic and the next sprite graphic. Clicking on the left hand arrow with the LEFT mouse button moves the sprites right (allows you to select the previous sprite), while clicking on the RIGHT button moves the sprites left (allows you to select the next sprite). The sprite in the middle is the currently selected sprite (CSS). Clicking on the left hand arrow with the RIGHT button positions the sprites so that the FIRST sprite is the CSS, while clicking on the right hand arrow with the RIGHT button positions the sprites so that the LAST sprite is the CSS. The arrows underneath the word "Layr" selects which layer will be currently edited. Clicking on the left hand arrow with the LEFT mouse button selects the previous layer, while clicking on the right hand arrow with the LEFT button selects the next layer. Clicking on the left hand arrow with the RIGHT mouse button selects the FIRST layer, while clicking on the right hand arrow with the RIGHT button selects the LAST layer. The characters underneath the word "Status" show the status of the sprite currently under the pointer. If a character is "lit up" (not grey), then that speciality is active. The specialities are : W - Walkability (Can the player move ONTO this tile ?) 1 - Special #1 (Is this tile in Special group #1) 2 - Special #2 (Is this tile in Special group #2) 3 - Special #3. This is different to the previous specialities in as much as when this is active a number will be displayed on the line below. These are the grid references (X and Y) of a tile that will be modified when the player steps onto the CSS. Beneath these values holds the layer of the tile that will be modified. You can only modify the specialities when in "normal editing mode". Version V4.00 ONLY : To do so, press the MIDDLE mouse button and go through all the questions at the bottom of the screen, and where appropriate entering values. The LEFT mouse button confirms a question, while the other two don't. The value to the right of the "Anim:" word contains the number of frames of animation for that tile. 8. Key commands ---------------- The following keys can be used in any mode : The Space bar - wraps around between normal editing, full screen editing and the Sprite Overlay System™ ⇦ ⇧ ⇨ ⇩ - Scrolls the editing or Overlay screen around Home - Re-displays the current layer from the top left 9. The Sprite Overlay System™ ------------------------------ This is a very powerful feature allowing you to position your sprites EXACTLY where you want them. Each layer is displayed from the first (or BASE layer) to the very last, in such a way that, created properly, all sprites at a certain position can be displayed. 10. Saving and loading ---------------------- Before editing can commence, a sprite file needs to be dragged to the !Mapper icon. If no valid sprites are found then an error message is displayed. MAP files can also be dragged to the !Mapper icon and will use the currently stored sprites. In addition, MAP files can also be loaded by double-clicking on the MAP icon. MAP files from !Mapper V3.xx is NOT compatible. To save a MAP file just drag the MAP icon to a directory, press the OK button or type in a filename. The selectable icon to the right of the icon graphic determines whether all layers are saved (star is in the box) or the current layer only is saved (box is clear). NOTE : Layers that are saved singly can ONLY be loaded into the layer that they were saved from. 11. MAP format -------------- The format of the MAP file is as follows : +0 (4 Bytes) - Header (&19861987) +4 (2 Bytes) - Map width +6 (2 Bytes) - Map height +8 (1 Byte) - Type of saving 0 - All layers saved >0 - Given layer is saved This is followed by the tile data : +0 (2 Bytes) - Sprite number +2 (1 Byte) - Sprite status - Bit 0 Set - Walkability Bit 1 Set - Special #1 Bit 2 Set - Special #2 Bit 3 Set - Special #3 +3 (1 Byte) - No. of frames of animation +4 (1 Byte) - X Modify location +5 (1 Byte) - Y Modify location +6 (1 Byte) - Modify layer value A. Glossary ------------ BASE LAYER - The first layer which is used to hold floor, walls, grass, doors, water and mud etc. sprites. TILE - A Sprite. SPRITE STATUS - Holds each tiles speciality. SPECIALITY - Defines how the player should react to a given tile. The specialities are : Walkability (can the player walk ONTO this tile ?), Special #1, Special #2 (These are for the user's use) and Special #3 (Which allows the programmer to modify a tile) SPRITE OVERLAY SYSTEM™ - Overlays layers so that A) You can position sprites correctly and B) You can see which sprites go where. LAYER - A group of tiles MODIFICATION LOCATION - Allows easy programming of 'hidden' walls etc., by storing the X, Y and layer number of the sprite the program has to modify. MAP - A group of layers B. And finally... ------------------ Whilst they shouldn't be any problems with the program, you can contact me by sending E-Mail to : nichk@argonet.co.uk C. The new bits... ------------------- Since this program was written, the StrongArm computer has come out. Being much faster than the programmers original computer, it was found that a slight modification was needed to allow the user to successfully choose different sprites and layers. In addition, a new 'speciality' has been added : The 'OPAQUE' speciality. This allows the programmer to code hidden doors, walls etc easily without having to use any of the original specialities. The specialities can now be entered in a much easier way using a 'LOCK'. Pressing the MIDDLE button within the editing area with put a red rectangle around the current sprite. This sprite is then locked. This means that, until the MIDDLE button is pressed again, the only thing you can modify on that tile is the specialities. To do that, press the LEFT mouse button over the 'W123O' letters to toggle them on and off. If speciality #3 is active, then, you can modify the modification X, Y and layer values by pressing the LEFT mouse button between the brackets. To modify the animation value, just LEFT click on the three numbers.